Inside Macintosh: Telephony /

Chapter 5 - Telephone Manager Messages / Telephone Manager Message Reference

Application-Defined Message Functions /

MyCAMsgHandler

Handles call appearance messages passed to it by the Telephone Manager.

pascal void MyCAMsgHandler (
                     TELCAHandle hTELCA,
                     long msg,
                     short mtype,
                     short value,
                     Ptr msgInfo,
                     long globals);

hTELCA

A handle to the call appearance record for the call appearance that originated the message.

msg

A value indicating the call appearance message to be processed. See "Call Appearance Messages" on page 5-14 for possible values for this parameter.

mtype

A constant used by some messages to further categorize the type of activity that is generating the event.

value

A constant used by some messages to provide specific details concerning the state of an activity.

msgInfo

The call appearance and the name of the party being called. If this information is not applicable or not available, this parameter is set to nil.

globals

A long integer for your use. You specify this value when you register the message handler, and the Telephone Manager passes the value unchanged to your message handler. You can use this value, for example, to access your application's global variables.

DESCRIPTION

Once you register your message handler and specify which messages to it should receive, the Telephone Manager passes those messages to your message handler.

IMPORTANT

The Telephone Manager sends an identical message to all registered message handlers that want to receive a given type of call appearance message. Therefore, your call appearance message handler cannot assume that a message refers to a call appearance your application is interested in. More than one application using the Telephone Manager can be running at the same time.

SEE ALSO

Use the TELCAMsgHand function (page 5-52) to register a call appearance message handler.

Call appearance messages are described in "Call Appearance Messages" on page 5-14.